home *** CD-ROM | disk | FTP | other *** search
/ IBM OEM Software Product … CD For PC Manufacturers / IBM OEM Software - Product Sampler CD for PC Manufacturers.iso / PersonalProductivity / Mail / BJLDAP / DISK1 / EMABLT.WRI < prev    next >
Text File  |  1997-03-10  |  16KB  |  363 lines

  1.  SIMPLE INTERNET
  2.  ADDRESS BOOK PROVIDER
  3.  
  4. for
  5. Windows 95 and Windows NT
  6.  
  7. Version 1.0.1 
  8.  
  9.  
  10. RELEASE NOTE 
  11.  
  12.  
  13. Boldon James Ltd.
  14.  
  15. 17th February 1997
  16.  
  17. P5255/001
  18.  
  19.  
  20. Please Note: Windows 95 and NT4 users should view this document with Wordpad (with Option WordWrap=WrapToWindow). NT3.51 users should open EMABLT.WRI using MS-Write.
  21.  
  22. 0.    Upgrade Version
  23.  
  24. An upgrade is available, that supports further facilities including: enhanced searching, local caching of directory information and access to multiple directories. Further information on this upgrade, including availability and pricing can be found at http://www.bj.co.uk/lotus.htm .
  25.  
  26. 1.    About This Release
  27.  
  28. This is Version 1.0.1 of the Boldon James Simple Internet Address Book Provider for Windows 95 and Windows NT (referred to in this release note as SIMPLE IAB). 
  29.  
  30. 1.1    Introduction
  31.  
  32. SIMPLE IAB is a MAPI compliant Address Book Service Provider and allows Lotus Mail to retrieve recipient mail addresses from an Internet Directory accessed via the Lightweight Directory Access Protocol (LDAP). 
  33.  
  34. The release note has the following sections:
  35.  
  36. 0.    Upgrade Version
  37. 1.    About this Release
  38. 2.    Environmental Requirements
  39. 3.    Installation, Uninstallation and Configuration Instructions
  40. 4.    Further Information About this Release
  41. 5.    Pre-configuring Network Installations
  42. 6.    The Deliverables
  43. 7.    Points To Note
  44. 8.    Customer Support Issues
  45.  
  46. Windows, Windows 95 and Windows NT are registered trademarks of Microsoft Corporation.
  47. Lotus Mail is a registered trademark of the Lotus Corporation.
  48.  
  49. 2.    Environmental Requirements
  50.  
  51. This release of SIMPLE IAB needs the following hardware and software:
  52.  
  53. 2.1    Minimum Hardware Required
  54.  
  55. * SIMPLE IAB needs a personal computer which is capable of running either Windows 95 or Windows NT.
  56. * 1.6MB disk space for the deliverables.
  57.  
  58. 2.2    Internet Directory 
  59.  
  60. SIMPLE IAB communicates with the Internet Directory over the LDAP protocol version 2.
  61.  
  62. The host machine for your Internet Directory should provide the following:-
  63.  
  64. * An Internet Directory.
  65. * LDAP server version 3.1 or higher (protocol version 2)
  66.  
  67. 2.3    Network Requirements
  68.  
  69. SIMPLE IAB needs the following TCP/IP software:
  70.  
  71. * Any TCP/IP stack that provides a Windows Sockets interface (WINSOCK). If Windows has been configured to run TCP/IP, this condition will normally be satisfied.
  72.  
  73. 2.4    Other Software Requirements
  74.  
  75. * Microsoft Windows 95 or Windows NT (v3.51 with Service Pack 3, or v4.0) must be installed.
  76. * The 32 bit MAPI subsystem, as supplied with Lotus Mail
  77. * A 32 bit MAPI Client, e.g. Lotus Mail for the Internet. 
  78.  
  79.  
  80. 3.    Installation, Uninstallation and Configuration Instructions
  81.  
  82. 3.1    Installing SIMPLE IAB
  83.  
  84. This release of SIMPLE IAB consists of two 3.5in high density (1.44MB) diskettes. 
  85.  
  86. The MAPI subsystem must be installed prior to installing SIMPLE IAB. Windows 95 and NT 4.0 installations provide this subsystem.  NT 3.51 users will have to install this separately.  Alternatively the MAPI Subsystem is provided as part of the Lotus Mail installation.
  87.  
  88. Always uninstall any previous version of the product before re-installing (see section 3.3 for instructions). Use either the Explorer shell, or Program Manager, as appropriate to the Windows version. Other shells may not function correctly.
  89.  
  90. The SIMPLE IAB installation program does the following:
  91.  
  92. * Copies the driver DLL's into the Windows system directory.
  93. * Copies support files into a directory of your choice (C:\Lotus\Mail32\Ldap by default), including this document.
  94. * Stores uninstall information in the Registry
  95. * On NT3.51, creates a Program Manager group "Simple Internet Address Book" to handle uninstallation.
  96.  
  97. 3.1.1    Installing on Windows 95 or NT4
  98.  
  99. To install SIMPLE IAB, perform the following:
  100.  
  101. * Insert the SIMPLE IAB disk into drive A:
  102. * Select the Start button, and then Settings, and Control Panel.
  103. * Select Add / Remove Programs.
  104. * Select Install from the first property page.
  105. * Follow the instructions in the wizard, making sure that it locates the file A:\SETUP.EXE
  106.  
  107. Alternatively:
  108.  
  109. * Insert the SIMPLE IAB disk into drive A:
  110. * Select the Start button, and then Run.
  111. * Enter "A:\SETUP.EXE" without the quotes, and then click OK.
  112.  
  113. 3.1.2    Installing on Windows NT3.51
  114.  
  115. To install SIMPLE IAB, perform the following:
  116.  
  117. * Move to "Program Manager" or "File Manager".
  118. * Select "File" and then "Run".
  119. * Enter the location of the SIMPLE IAB Install files, followed by "\SETUP.EXE".
  120. * Click OK, and then follow the on screen instructions.
  121.  
  122. Alternatively, perform the following steps:
  123.  
  124. * From Program Manager, start "Control Panel".
  125. * Select the "Mail & Fax" applet.
  126. * Select a MAPI profile, if one is not already selected, and selected "Properties".
  127. * Select "Add", and then "Have Disk".
  128. * Follow the on screen instructions.
  129.  
  130. Once installed, the Program Manager group Simple Internet Address Book will contain icons for uninstalling SIMPLE IAB, and for reading this document.
  131.  
  132. 3.1.3    Adding SIMPLE IAB to a MAPI profile
  133.  
  134. Before you can use SIMPLE IAB you must add it to an appropriate MAPI profile.
  135.  
  136. You can add SIMPLE IAB to a profile from the Control Panel Mail and Fax applet as follows:-
  137.  
  138. * Choose Show Profiles and select the required profile from the list of configured profiles.
  139. * Choose Properties then Add.
  140. * In the Add Service to Profile dialog select 'Internet Directory Access' from the list of available information services and choose OK.
  141.  
  142. Tip
  143.  
  144. If, after installation, you find that the Add Service To Profile listbox does not contain the "Internet Directory Access" option, or you want to change the defaults in EMABLT.INF and have them reflected in all future new profiles, switch to the Installation Directory as chosen above, and run, from a DOS shell:
  145.     BJMRGINI EMABLT.INF
  146. This merges the EMABLT.INF file into the MAPISVC.INF file which is used whenever the "Internet Directory Access" provider is added to a MAPI profile.
  147.  
  148.  
  149. 3.2    Using the SIMPLE IAB Service Entry to configure SIMPLE IAB 
  150.  
  151. You can configure SIMPLE IAB in two ways, as follows :
  152.  
  153. * Control Panel, using the 'Mail & Fax' applet.  Select 'Internet Directory Access' and press 'Properties'
  154. * Lotus Mail, using Services item on the Tools menu which is on the File menu.
  155.  
  156. 3.2.1    General
  157.  
  158. See your system administrator to gather the information for this sheet. 
  159.  
  160. Server Hostname [required]
  161. The name of the machine which is running your LDAP server. This can be a host name or a TCP/IP address. 
  162.  
  163. Server Port Number[required]
  164. This defines what port number the LDAP server is listening on. Default port is 389.
  165.  
  166. User Name
  167. The distinguished name of the directory user for binding to the server. If blank, anonymous binding is attempted.  The format is as follows e.g.
  168.     cn=Joe Smith,ou=development,o=Lotus,c=us
  169.  
  170. Password
  171. Password for authentication of the directory user. Leave blank if anonymous binding is permitted.
  172.  
  173. Search Base 
  174. This specifies the level of the Internet Directory to use as the root for any search operations.  The format is as follows  e.g.
  175.         o=Lotus, c=us
  176. For more information contact your directory administrator.
  177.  
  178. 3.3    Uninstallation
  179.  
  180. * Close down the Lotus Mail client and any other MAPI applications that are running.
  181.  
  182. * Any MAPI profile containing references to SIMPLE IAB will not be altered; consequently they will fail when used.  Edit these profiles via the "Mail and Fax Applet" and remove any reference to SIMPLE IAB.
  183.  
  184. * The MAPI Profile editor will continue to see SIMPLE IAB as a service available to be added to profiles, because the file MAPISVC.INF still contains the SIMPLE IAB service. Either edit this file to remove the first line with EMABLT on, or, prior to uninstalling, in a DOS shell, change directory to the directory SIMPLE IAB was installed in, and run "BJMRGINI EMABLT.INF -R".
  185.  
  186. * On Windows 95 and NT4, call up the Control Panel and select Add/Remove Programs. Internet Directory Access will be seen in the list. Select with care and press Add/Remove. It will be removed.
  187.  
  188. * On Windows NT3.51, run the Uninstall program from the icon in the SIMPLE IAB Program Manager group.
  189.  
  190. 4.    Further Information About this Release
  191.  
  192. 4.1    Performing a search with SIMPLE IAB
  193.  
  194. The SIMPLE IAB help describes how to search the Internet Directory for a mail address and display the properties associated with a matching entry. This can be found in the support files directory (C:\Lotus\Mail32\Ldap by default), or can be selected from the Program Menu on Windows 95 and NT 4.0
  195.  
  196.  
  197. 5.    Pre-configuring Network Installations
  198.  
  199. This section is for the use of mail administrators and developers. Other users may wish to skip this material.
  200.  
  201. The following describes how to configure the SIMPLE IAB installation disk images so that users can be configured as automatically as possible with company defaults.
  202.  
  203. 5.1    Overview of Network Installation
  204.  
  205. The files on the release disk #1 include:
  206.  
  207. EMABLT.WRI        This release note, in uncompressed form.
  208. EMABLT.INF        The SIMPLE IAB configuration file.
  209.  
  210. The document files can be replaced by corporate versions.
  211.  
  212. EMABLT.INF contains the default settings for an SIMPLE IAB profile. During installation, this file is copied to the support directory, and then merged with MAPISVC.INF - a file that MAPI uses to create profiles. Alter EMABLT.INF to change the default MAPI profile to match the corporate environment and Internet Directory usage.
  213.  
  214. After customising disk #1, copy both diskettes onto a network server under two folders at the same level , called "disk1" and "disk2". Instruct users to run SETUP in the "disk1" folder, and then to configure a new profile, or add SIMPLE IAB to an existing profile, using the Control Panel applet.
  215.  
  216. 5.2    Customising EMABLT.INF
  217.  
  218. EMABLT.INF is a standard text file. Use any convenient editor.
  219.  
  220. The file consists of several sections  - only [EMABLT] is of  interest. Restrict editing to the [EMABLT] entries that begin with numeric digits.
  221.  
  222. The lines in this section consist of 8-character hexadecimal 'property tags', followed by '=', and then the value corresponding to the property. 
  223. In each of the 8-digit values the trailing 2 characters indicate the type of data to MAPI:
  224.  
  225.     1e - string (without quotes)
  226.     03 - long integer (8 numeric digits)
  227.     0b - boolean (value of 0100 means TRUE/ON, 0000 FALSE/OFF)
  228.  
  229. The remainder of this section will describe the tags and format of the values you need to enter in this section of the file. Default values are applied if the property is not present in the EMABLT.INF file. Section 5.3 contains the released EMABLT.INF file. 
  230.  
  231. Property        Format
  232.  
  233. 6600001e        This is the IP address or host name of the machine containing the                 LDAP server.  Default ldap.bigfoot.com. 
  234. 6601001e        The port number that the LDAP server is listening on. Default 389. 
  235. 6602001e        The distinguished name of the user. This value is not required if you                 allow anonymous binds. Default none - blank.
  236. 6603001e        The Search Base e.g. "o=boldon james limited, c=GB". Default c=us.
  237. 6604001e        The Search Filter in RFC1777 format with %s allowed as a                     substitution token for the name to be searched for e.g.                         (|(cn=*%s*)(sn=*%s*)) to perform a contains search on common                     name or surname. Default cn=*%s*.
  238. 6605001e        The address type to be used by MAPI in message submission.                     Default SMTP.
  239. 6606001e        The E-Mail Attribute, e.g. mail, mhsOrAddresses or rfc822Mailbox,                 which is to be mapped to the MAPI PR_EMAIL_ADDRESS property.                 Default is mail.
  240. 6607001e        LDAP Time Limit for searching (in seconds). The maximum length of                 time to search the directory. A value of 0 means that the search will                 not be limited by time. Note that this will not necessarily supersede                 any system-wide limits defined on the server. Default is 60. 
  241. 6608001e        LDAP Size limit for searching (in number of "hits"). The maximum                 number of matches to return. A value of 0 means that there is no limit                 to the number of matches. Note that this will not necessarily                     supersede any system-wide limits defined on the server. Default is                 100.
  242. 6609001e        As 6607001e but for low bandwidth links. Default is 120.
  243. 660a001e        As 6608001e but for low bandwidth links. Default is 15.
  244. 660b001e        Log File (full pathname). Default None.
  245. 660c000e        Error Logging Levels , ON or OFF. Default is OFF.
  246. 660d000e        Diagnostic Tracing Levels, ON or OFF. Default is OFF.
  247. 660e001e        Boldon James detailed tracing levels.  Default is NONE.
  248. 660f001e        Output to debug Window, ON or OFF. Default is OFF.
  249. 6610001e        Attribute to be used within an Internet Directory entry for populating                 the Additional Information filed on the user mail details property sheet.             Default is postalAddress.
  250. 6611001e        Attribute to be used within the Internet Directory entry for populating                 the user Display Name. Default is cn. 
  251. 6612001e        Attribute to determine if a dialog will be displayed when a search to                 the Internet Directory fails.  The dialog will display additional                     information.  Values can be either 1 (display) or 0 (do not display). 1                 is the default.
  252.  
  253. 5.3    An example EMABLT.INF
  254.  
  255. Items in italics are comments in this section. They should not be included in the EMABLT.INF file.
  256.  
  257. [Services]
  258. EMABLT=Internet Directory Access        don't alter this section
  259.  
  260. [Help File Mappings]
  261. EMABLT Help=EMABLT.HLP            don't alter this section
  262.  
  263. [EMABLT]
  264. PR_DISPLAY_NAME=Internet Directory Access
  265. Providers=PRO_EMABLT
  266. PR_SERVICE_DLL_NAME=EMABLT.DLL
  267. PR_SERVICE_SUPPORT_FILES=EMABLT.DLL
  268. PR_SERVICE_DELETE_FILES=EMABLT.DLL
  269. PR_SERVICE_ENTRY_NAME=ServiceEntry
  270. PR_RESOURCE_FLAGS=SERVICE_SINGLE_COPY | SERVICE_NO_PRIMARY_IDENTITY
  271. WIZARD_ENTRY_NAME=WizardEntry
  272.             Edit this part below
  273. 6600001e=ldap.bigfoot.com            server hostname
  274. 6601001e=389                    port number
  275. 6602001e=                    user name
  276. 6603001e=c=us                    search base
  277. 6604001e=cn=*%s*                search filter
  278. 6605001e=SMTP                address type
  279. 6606001e=mail                    email address source
  280. 6607001e=60                    ldap time limit
  281. 6608001e=30                    ldap size limit
  282. 6609001e=120                    ldap time limit - low bandwidth
  283. 660a001e=15                    ldap size limit - low bandwidth
  284. 660b001e=                    path to log file
  285. 660c001e=OFF                    error logging
  286. 660d001e=OFF                    Diag tracing
  287. 660e001e=NONE                Trace Level
  288. 660f001e=OFF                    output to debug window
  289. 6610001e=postalAddress            additional info source
  290. 6611001e=cn                    display name source
  291. 6612001e=1                    display dialog box on failure to search                                 Internet Directory.
  292.  
  293. [PRO_EMABLT]                do not alter this section
  294. PR_PROVIDER_DLL_NAME=EMABLT.DLL
  295. PR_PROVIDER_DISPLAY=Internet Directory Access
  296. PR_RESOURCE_TYPE=MAPI_AB_PROVIDER
  297.  
  298.  
  299. 6.    The Deliverables
  300.  
  301. SIMPLE IAB consists of the following software and documentation:
  302.  
  303. 6.1    Software
  304.  
  305. Listed below are the files delivered into your Windows System directory and your supporting files directory. An entry of [no info] in the version column means that particular file has no version information. The software is virus checked before release.
  306.  
  307. 6.1.1    Support Files
  308.  
  309. File                        
  310. emablt.hlp            
  311. emablt.inf             
  312. bjmrgini.exe        
  313.  
  314.  
  315. 6.1.2    Windows System Files
  316.  
  317. File                Version            
  318. bjlog32.dll            3.2.0.0            
  319. emablt32.dll            1.0.1.0            
  320. ldap32.dll            3.3.0.1            
  321. bjablr32.dll            1.0.1.0            
  322. bjsrch32.dll            1.0.1.0                    
  323. mfc42.dll            4.2.6256        
  324. msvcrt.dll            4.20.6201        
  325.  
  326. 6.2    Documentation
  327.  
  328. SIMPLE IAB is released with the following documentation:
  329.  
  330. EMABLT.WRI - Simple Internet Address Book Provider Release Note
  331. EMABLT.HLP - Boldon James Simple Internet Address Book Provider Help
  332.  
  333. 7.     Points To Note
  334.  
  335. 7.1    Uninstall
  336.  
  337. If you install SIMPLE IAB more than once, then the Uninstall process will leave shared DLLs on your system.  Refer to 6.1.2 for a list of DLLs installed by this product.
  338.  
  339.  
  340. 8.    Customer Support Issues
  341.  
  342. If you have any support issues, or other queries about this product, please contact:
  343.  
  344.     Customer Services Unit
  345.     Boldon James Ltd.
  346.     Brundrett House
  347.     Sandbach Road South
  348.     Alsager
  349.     Stoke-on-Trent. ST7 2LT
  350.     England
  351.  
  352.     Telephone: +44 (0) 1270 844006
  353.     Facsimile: +44 (0) 1270 883631
  354.  
  355.     Email:    support@bj.co.uk
  356.     X400:    s=support;o=Boldon James limited;p=bj;a=ospmail;c=gb    
  357.     World Wide Web:    http://www.bj.co.uk
  358.  
  359. Boldon James Simple Internet Address Book Provider
  360. Version 1.0.1
  361.  
  362.  
  363.